home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 033a / comzipv2.zip / COMZIPV.DOC next >
Text File  |  1989-09-16  |  8KB  |  233 lines
  1.  
  2.  
  3.                 ComZipv version 1.2 for PCBoard 14.?
  4.                         by Dennis Wynne
  5.             Troll's Cave PCBoard (615) 242-7909 1200/2400
  6.  
  7. What ComZipv Does:
  8.     
  9.        Acts as a replacement for your current ZIP view program (F V command).
  10.     When called, ComZipv interrogates the serial port and saves the current
  11.     state and interrupt vector. The program then displays the contents of
  12.     the ZIP file indicated by the %1 argument passed from PCBoard. All output
  13.     is sent directly out the com port and echoed to the local BBS screen.
  14.     The user is then prompted to read files contained in the ZIP, test the
  15.     integrity of the ZIP, list zip contents again, or quit back to bbs.
  16.     Input is checked for constantly at both the com port and the local 
  17.     keyboard. In addition there is an internal timer, if the user sits at
  18.     a prompt too long (2-3 minutes) the program supplies a negative response
  19.     (if at a More prompt, a N is supplied, if at the Main prompt the user is
  20.     'Quit' back to PCBoard. The sysop can interrupt at any time by hitting
  21.     one of the function keys.
  22.  
  23.        Version 1.2 introduces a couple of new features:
  24.       
  25.        The ability (as set by the SysOp) to select other ZIP files to view.
  26.        A timelimit (can be set by SysOp) that defaults to 10 minutes.
  27.        Will now handle 'Imploded' files.
  28.  
  29.        All routines are internal to ComZipv, it does not shell out to call 
  30.     PkUnzip, etc. The program does not do any dynamic memory allocation so
  31.     the program should run fine in about 90k.
  32.  
  33.        ComZipv take wildcards for the file to be read, it tries to 
  34.     intelligently parse this filespec, unlike DOS (Ex:  *CH.*  will show all 
  35.     the files that have a CH in the filename, any extension. DOS would show
  36.     all the files). Before a file is displayed it is 'analyzed' to see if it
  37.     can be displayed in text format, if it appears that it cannot, it will be
  38.     displayed in hex dump format complete with offset, hex bytes, and 
  39.     'printable' characters.
  40.  
  41.        ComZipv monitors the carrier detect state, and will immediately return
  42.     to PCBoard if carrier is lost.
  43.  
  44.        ComZipv makes an 'empty' PCBVIEW.TXT file for PCBoard to display
  45.     when the caller returns to PCBoard.
  46.  
  47.        All serial port parameters/interrupts are restored to their original
  48.     state before the program exits.
  49.  
  50.     NOTE: ComZipv has no way of knowing if you are in 'LOCAL' mode, so if
  51.           carrier detect is not active when the program starts it will act
  52.           like the normal View program. It will create a PCBVIEW.TXT file
  53.           and write the 'view' to it for pcboard to display. So in local
  54.           mode you will not get the benefit of the Test, Read,and Change
  55.           Zip file functions.
  56.  
  57.  
  58.  
  59. Usage:
  60.        ComZipv  ZipFileSpec[.ZIP] Comport [TimeLimit]
  61.  
  62.         where ZipFileSpec is fully qualified, complete with Drive, Path, and
  63.              FileName. The .ZIP extension is optional.
  64.  
  65.         where Comport is 1, 2, 3, or 4.
  66.               {I know PCBoard only supports 1 & 2, but 3 & 4 are there 
  67.                for completeness/testing}
  68.  
  69.         where TimeLimit is optional time allowed in ComZipv (1-999 minutes)
  70.               default is ten minutes.
  71.  
  72.   or   ComZipv  /SETUP
  73.  
  74.         to change the BBS name, Prompt, and page length.
  75.  
  76.  
  77.  
  78. Example:
  79.  
  80.  If your current PCBVIEW.BAT file contained this:
  81.  
  82.                                 PKUNZIP -V %1 > PCBVIEW.TXT
  83.  
  84.  Replace that line with:
  85.  
  86.                                 COMZIPV %1 1 15     
  87.  
  88.    Note: Do not use the redirection ( > PCBVIEW.TXT ) or the caller will
  89.          have to look at all the data twice, and the local monitor can
  90.          remain blank for several minutes.
  91.  
  92.  
  93.  
  94. Setup:
  95.  
  96.        ComZipv can modify itself, allowing you to change:
  97.  
  98.             1) The BBS Name.  Currently Set for: Troll's Cave 
  99.  
  100.             2) The Prompt.    Currently Set for:
  101.            (R)ead Zip contents, (L)ist ZIP again, (T)est ZIP, (Q)uit to BBS :> 
  102.  
  103.             3) The Page Length. Currently Set for 23
  104.  
  105.        
  106.         Run  ComZipv /SETUP
  107.         Alter the items you want to change
  108.         Save the changes (ComZipv will find and alter itself)
  109.  
  110.  
  111. To Allow callers to select a different ZIP file:
  112.  
  113.           Place a text file called COMZIPV.DIR in your 'default' PCB directory
  114.         (i.e. C:\PCB\) that contains every Drive\Path combination that you 
  115.         want searched.
  116.           If this file is omitted, the C)hange ZIP File option will NOT be
  117.         present (or allowed).
  118.  
  119.    Example:
  120.  
  121.         E:\I14
  122.         G:\I1
  123.         G:\I3
  124.         F:\I2
  125.         F:\I4
  126.         H:\I5
  127.         H:\I6
  128.         H:\I10
  129.         J:\I11
  130.         J:\I12
  131.         J:\I13
  132.         K:\I7
  133.         K:\I8
  134.         K:\I9
  135.  
  136.  
  137.         Would search all of the above drive:\path combinations for the 
  138.         next file chosen by the caller. Note that the current (default PCB
  139.         directory is NOT searched for the new ZIP file).
  140.         
  141.  
  142.  
  143.  
  144. Bugs, Changes, and Improvements:
  145.  
  146.        If you encounter any bugs or have any suggestions for improvements
  147.     in ComZipv please call my board or leave me a message on Salt Air.
  148.  
  149.        I would like to speed up the test and read times, and will be working
  150.     toward that goal.
  151.  
  152.  
  153.  
  154.  
  155. Notes:
  156.        ComZipv opens the Zipfile in share compatible 'deny-none' mode.
  157.  
  158.        The SysOp can hit a function key at any time to interrupt or
  159.        return the caller to PCBoard.
  160.  
  161.        The caller can hit Control X, Control C, Control S, or Control Q
  162.        to interrupt the display (and produce a More Y/N/C prompt) at any
  163.        time.
  164.  
  165.        To test the 'on-line' features of ComZipv on your computer you can:
  166.  
  167.          1) Set up your modem with AT&C0&D0Q1E0
  168.             (This will turn on Carrier Detect to fool ComZipv and
  169.              disable Echo and Command results)
  170.          2) Then run ComZipv and give it the complete path & name of a
  171.             Zip file, plus the Comport for your modem.
  172.          3) Don't forget to reset your modem when done.
  173.          4) HINT: After you set up the modem as in step 1,
  174.                   change the baud rate up to a high rate (9600+).
  175.                   This will allow your display to scroll faster.
  176.  
  177.          
  178.  
  179. Version History:
  180.      
  181.        Release 1.0 - Initial Release 7/23/89
  182.  
  183.        Release 1.1 - 07/24/89 
  184.                      Found odd bug: if reading text file and a cr/lf
  185.                      occurred at the exact end of internal buffer, the
  186.                      program would start displaying garbage.
  187.        
  188.        Release 1.2 - 09/16/89
  189.  
  190.                      Lots of new stuff: Imploded files now supported,
  191.                      time limit, choosing other files to View, Read, or
  192.                      Test.
  193.  
  194.  
  195.  
  196. Disclaimer:
  197.  
  198.   I wrote ComZipv for myself to allow callers to read and test ZIP files
  199. without having to Open ProDoor. I run this exact program on my three node
  200. PCBoard setup with no problems. I assume no responsibility for the results of
  201. using this program. If there are any bugs in this program, let me know, I'll
  202. try to fix them. If you decide to use this program, any damages, loss of
  203. use, etc. are YOUR responsibility.
  204.  
  205.  Dennis Wynne            
  206.  Troll's Cave PCBoard                Mail:  P.O. Box 101030   
  207.  (615)242-7909 1200/2400                    Nashville, TN 37210
  208.  
  209.  
  210.  
  211.  
  212. Registration:
  213.  
  214.   There isn't any ! These programs are free to my fellow SysOp's (or anyone
  215. else who wants to use them).
  216.  
  217.  
  218. Optional (NOT Required at all):
  219.  
  220.   If you send a donation of $10 or more, along with your BBS phone number(s),
  221. and a valid logon for me to use. I'll call YOU and upload the latest versions
  222. as I make changes, fix bugs, etc.
  223.  
  224.  
  225.  
  226. p.s. I you like and use ComZipv, please call the board sometime and let me
  227.      know (or leave me a note on Salt Air or RelayNet).
  228.  
  229. p.s.s. Like I always say: It's Troll-Ware, so it's FREE!!!!!
  230.  
  231.  
  232.  
  233.